1 Setup

This installation walkthrough based on personal machine through a virtualization tool. Because of the resource limitation, we will only create a single node.

Here is the material required for the installation.

  • Virtual Box 6.1.26
  • IIIDevOps-rke-v1.7.1-202108181553.iso

2 Settings

1. Create a VM on Virtual Box:

Here are the details of the final settings of the vm. We will specifically talk about network setup in the next step.

2. Network Configuration: Below is my network setup. But this setup should work in most situation as long as your host computer can connect to a internet. NAT Network is for network traffic reaching to the internet and Host Only Network is for your host computer can access services in your VM from host machine.

For Mac user, first click VirtualBox -> Preferences -> Network. You will see pop up screen as below, and click Adds new NAT network.

Then double click on the new created NATNetwork. Please change your network CIDR to 10.20.0.0/24. This will be the private network block assigned to your vm. The default gateway will be the first ip of the CIDR block. For example gateway of network 10.20.0.0/24 will be 10.20.0.1.

Now we will set up another adapter. Go to File -> Host Network Manager. It will look something like below. First Create one and check enable DHCP Server [optional].

After done configuring the network adapter, be sure to add both adapter to your VM. No additional configuration required.

3 Install iiidevops

Be sure to load IIIDevOps-rke-v1.7.1-202108181553.iso image in your IDE Controller storage. You can safely start the virtual machine. This step will be seperated into two sections: linux system install and service deploy.

3.1 system install

There are several steps involve but most of them should be the same.

  • ip (only configure nat adapter one’s): 10.20.0.70/24 (since we are using ip-domain name setup by iii in Google DNS 8.8.8.8, this ip is fixed)

  • gateway: 10.20.0.1 (this is virtualbox’s default for this CIDR and can not be changed)

  • name server: 8.8.8.8

  • partition disk: use entire disk and set up LVM just choose default for the subsequent questions

  • Install the grub boot loader on a hard disk: Yes

  • IIIDevops roles: ALL (This will configure this node to be both a master and worker)

  • hostname: Can be anything, easy to remember

  • base Service IP, K8s IP, NFS IP, NFS Shared Directory: All using default

  • version: standard

  • deployment mode: DNS (IP can also work)

  • Domain name settings: (If you choose DNS deployment mode)

    • rancher-iso.iiidevops.org
    • gitlab-iso.iiidevops.org
    • harbor-iso.iiidevops.org
    • redmine-iso.iiidevops.org
    • sonarqube-iso.iiidevops.org
    • k8sctl-iso.iiidevops.org
    • ingress-iso.iiidevops.org
    • iso.iiidevops.org

  • IIIDevops (portal) super user: anything easy to remember

  • all service admin password and sudo password

After system installation, the system will reboot. Using rkeuser (sudo user) and password setting above to login and continue the application installation.

3.2 Application Installation

After login, we need to setup second network adapter (host-only) since during our previous system installation we can only set up one adapter (nat).

  • Press control-c to disrupt the installation.
  • enter sudo nano /etc/netplan/01-netcfg.yaml in the command line
  • finish settings like the following. (choose a fixed ip or dynamica ip provided by dhcp)
  • save and exit the text editor
  • reboot the machine and login again to finish the application install

After installation one can check how the things work using following url:

If you choose DNS during installation:

If you choose IP during installation:

**Note Harbor is not able to use ip-port url when you have domain name configured. This may require further modification or feedback to iii.

Finally, the iiidevops portal is not up yet because it also requires pipeline setting up first which we will deal with in another documentation.